Documentation update for combo_box_new_with_entry
authorDarkTrick <notebook22312@gmail.com>
Fri, 4 Jun 2021 04:02:48 +0000 (04:02 +0000)
committerMatthias Clasen <mclasen@redhat.com>
Fri, 4 Jun 2021 04:02:48 +0000 (04:02 +0000)
gtk/gtkcombobox.c

index a8a3842aca39f3164c39097bbe5a15e75691e312..70d0f637a3cb94e08db8f5a81b042c67362ca225 100644 (file)
@@ -1851,6 +1851,10 @@ gtk_combo_box_new (void)
  *
  * Creates a new empty `GtkComboBox` with an entry.
  *
+ * In order to use a combo box with entry, you need to tell it
+ * which column of the model contains the text for the entry
+ * by calling [method@Gtk.ComboBox.set_entry_text_column]. 
+ *
  * Returns: A new `GtkComboBox`
  */
 GtkWidget *
@@ -1885,6 +1889,8 @@ gtk_combo_box_new_with_model (GtkTreeModel *model)
  *
  * Creates a new empty `GtkComboBox` with an entry and a model.
  *
+ * See also [ctor@Gtk.ComboBox.new_with_entry].
+ *
  * Returns: A new `GtkComboBox`
  */
 GtkWidget *
@@ -2674,7 +2680,10 @@ gtk_combo_box_get_has_entry (GtkComboBox *combo_box)
  *   the internal entry
  *
  * Sets the model column which @combo_box should use to get strings
- * from to be @text_column.
+ * from to be @text_column. 
+ *
+ * For this column no separate 
+ * [class@Gtk.CellRenderer] is needed.
  *
  * The column @text_column in the model of @combo_box must be of
  * type %G_TYPE_STRING.